home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / misc / vhlogger_v2.lzh / vhlogger.rexx < prev    next >
OS/2 REXX Batch file  |  1992-07-19  |  5KB  |  222 lines

  1. arexx commands:
  2.  
  3. back      - move vhlogger window to back.
  4.         arexx example "back"
  5.  
  6. close      - close the data base.
  7.         arexx example "close"
  8.  
  9. delete      - delete the current record.
  10.         example "delete"
  11.  
  12. find CALL - find and retrieve a record for CALL, record in same order as update.
  13.         example "find ka8cte"
  14.         or         x = 'ka8cte'
  15.              "find" x
  16.  
  17. first      - go to the first record in the data base, retrieve it.
  18.         example "first".
  19.  
  20. front      - move vhlogger window to front.
  21.         example "front"
  22.  
  23. next      - go to the next record, retrieve it
  24.         example "next"
  25.  
  26. open FILE - open an existing data base FILE.  Do not include the suffix.
  27.         example "open vhdata".  The rexx interface does not allow
  28.         you to open a file that does not exist (eg the create mode).
  29.  
  30. quit      - vhlogger ends.
  31.         example "quit"
  32.  
  33. update      - update the display and the data base using positional data as
  34.         described below.
  35.         See below for examples.
  36.  
  37. version   - retrieve version number.
  38.         example:
  39.         /* rexx */
  40.         options results
  41.         address 'vhlogger'      /* assume vhlogger is running */
  42.         'version'               /* issue the command */
  43.         say result            /* SAY the result */
  44.         /* end rexx */
  45.         sample output:
  46.         $VER: VHlogger 2.03 by Vincent Herried (KA8CTE)
  47.  
  48. * * * * * * * * *
  49.  
  50.  
  51.  
  52. The semicolon delimited data is in the following order:
  53.   callsign
  54.   name
  55.   date - YYMMDD
  56.   start time
  57.   end time
  58.   rst sent
  59.   rst received
  60.   address
  61.   city
  62.   state
  63.   zip
  64.   comment
  65.  
  66.   srh  - qsl send Y or N; qsl received Y or N;from home qth Y or N
  67.      example if qsl card sent, not received, and contact made from
  68.      home qth this field will be YNY
  69.  
  70.   Band_number - as follows:
  71.    0 "     "
  72.    1 "160M",
  73.    2 "80M",
  74.    3 "40M",
  75.    4 "30M",
  76.    5 "20M",
  77.    6 "17M",
  78.    7 "15M",
  79.    8 "12M",
  80.    9 "10M",
  81.   10 "6M",
  82.   11 "2M",
  83.   12 "1.25M",
  84.   13 "70CM",
  85.   14 "33CM",
  86.   15 "23CM",
  87.   16 "other",
  88.  
  89.   Power_name
  90.    0 "    "
  91.    1 "1W",
  92.    2 "5W",
  93.    3 "50W",
  94.    4 "200W",
  95.    5 "1KW",
  96.    6 "2KW",
  97.  
  98.  
  99.   Ant_name
  100.    0 "      "
  101.    1 "RANDOM",
  102.    2 "DIPOLE1",
  103.    3 "DIPOLE2",
  104.    4 "DIPOLE3",
  105.    5 "DIPOLE4",
  106.    6 "VERT 1",
  107.    7 "VERT 2",
  108.    8 "VERT 3",
  109.    9 "VERT 4",
  110.   10 "BEAM 1",
  111.   11 "BEAM 2",
  112.   12 "BEAM 3",
  113.   13 "BEAM 4",
  114.   14 "DUCK",
  115.   15 "QUAD",
  116.   16 "DISH",
  117.   17 "HELIX",
  118.   18 "other",
  119.  
  120.   Mode_name
  121.    0 "    "
  122.    1 "CW",
  123.    2 "SSB",
  124.    3 "FM",
  125.    4 "AM",
  126.    5 "AMTOR",
  127.    6 "RTTY",
  128.    7 "PACKET",
  129.    8 "ASCII",
  130.    9 "FAX",
  131.   10 "SSTV",
  132.   11 "FSTV",
  133.   12 "other",
  134.  
  135.  
  136.   "."
  137.  
  138. Update command examples:
  139.  
  140. example 1.
  141.  
  142.       REXX command:
  143.  
  144.       "update ka8cte;Vince Herried;920705;0700;0800;588;599",||
  145.       ";1688 Staffordshire RD;Columbus;OH;43229;The author;YYY",||
  146.       "0;0;0;0"
  147.  
  148.       Explaination:
  149.       Update call sign KA8CTE with the following values:
  150.       name = Vince Herried
  151.       date = 07/05/92
  152.       start time = 07:00
  153.       end time = 08:00
  154.       rsts = 588
  155.       rstr = 599
  156.       address = '1688 ....'
  157.       city = 'Columbus'
  158.       state = 'OH'
  159.       zip = 43229
  160.       comments = 'The author'
  161.       qsl has been sent and received.
  162.       contact made from your QTH
  163.       band, power, antenna, and mode set to " ".
  164.  
  165. example 2.
  166.  
  167.  
  168.       "update ka8cte;Vince Herried;920705;0700;0800;588;599",||
  169.       ";;;OH;;a CW freak;xxx",||
  170.       "0;0;0;1"
  171.  
  172.       Update call sign KA8CTE with the following values:
  173.       name = Vince Herried
  174.       date = 07/05/92
  175.       start time = 07:00
  176.       end time = 08:00
  177.       rsts = 588
  178.       rstr = 599
  179.       address = ''
  180.       city = ''
  181.       state = 'OH'
  182.       zip = ''
  183.       comments = 'a CW freak'
  184.       qsl has not been sent and not received.
  185.       contact was not made from your QTH   (note any value other than 'Y' in
  186.       these fields is intrepreted as 'N'.  'y' is not 'Y' ok?)
  187.       band, power, and antenna set to " ".
  188.       mode = 'CW'
  189.  
  190. * * * * * * * * * * * * *
  191. To start vhlogger and use an arexx macro called 'temp.vh' enter following from
  192. your CLI prompt:
  193.       vhlogger temp
  194.  
  195. The program will start up and invoke a rexx exec in your current directory
  196. named 'temp.vh'
  197.  
  198. Alternatively you may start vhlogger in one window and
  199. then start the arexx exec in a different window.
  200. Or you can have your arexx exec start vhlogger, see the example qsl.rexx
  201.  
  202. Assume that vhlogger is running and the data base is open. Here is a sample
  203. arexx exec.
  204.  
  205.        /* temp.rexx  */
  206.  
  207.        options results
  208.  
  209.        address "vhlogger"
  210.        call = 'ka8cte'
  211.        'find' call
  212.        say 'Return code =' RC  /* 0 = record found */
  213.        if RC = 0 then say "Result="RESULT;
  214.        /* end of rexx */
  215.  
  216. You could see something like the following from the above:
  217. RC=0
  218. Result=KA8CTE;Vince Herried;920701;0700;0800;;;1688 Staffordshire;
  219. Columbus;OH;43229;usnet addr is vjh21@cas.org;YYY;0;0;0;0.
  220.  
  221.  
  222.